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MAPPING RENDERMAN TO OPENGL 

The RenderMan data types can be mapped onto data In the OpenGL pipeline as follows: float is 
either a single component buffer or the red channel of a color buffer; point and color are three- 
component vectors that map to the red, green, and blue channels of colors In the pipe. Strings are 
kept on the host. 

float scalar variable (no other scalar data types) 

string file identifier 

point vector of three floats 

color vector of any nuinber (usually 3) of floats 

Global variables typically can be computed in a single pass from the host. The most touchy 
parameters are the surface derivatives. We do need a pass-through of the interpolated and 
normalized vectors (such as the normal vector) and a gen-color mechanism to get interpolated 
points (such as P). 

color Cs Surface color (input) 

color OS Surface opacity (input) 

point P Surface Position 

point dPdu Change in position with 'u' 

point dPdv change in position with 'v' 

point N Surface shading normal 

point Ng Surface geometric normal 

float u,v Surface parameters 

float du,dv change in u,v across element 

float 3,t surface texture coordinates 

float L Direction from surface to light source 

color CI Light color 

point Ci Color of light from surface (output) 

point Oi Opacity of surface (output) 

point E Position of the camera 

point I Direction of ray impinging on surface 

The RenderMan operators map relatively painlessly to the operations already present in OpenGL. 
In some cases, however, we will need to use a lookup table to achieve the results. We often have 
several choices of OpenGL operations to reach our goals; the decision made will depend on the 
best option for a given platform. 

0 left expression grouping 

-! right unary arithmetic and logical negation 

left dot product 

*/ left multiplication and division 

" left cross product 

+- left addition and subtract4.on 

= > left arithmetic comparison 

== != left equal and not equal 

ss left logical and 

1 I left logical or 

? ! right conditional expre 

= right assignment 

Arithmetic (a and b are float, point, or color): 



Draw(a) ; 

glBlendFunc (GL_DST_COL0R, GL_ZERO) ; 
glColor4f (-l.,-l.,-l.,l.) ; 
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Draw (a) ; 
glBlendFunc (GL_ONE, GL_ONE) ; 
Draw(b) ; 



Draw(a) ; 
glBlendFunc (GL_ONE , GL_ONE) ; 
glBlendEquatioiiEXa? (GI._FUNC_SUBTRACT_EXT) ; 

Draw(b) ; 



Draw (a) ; 

glBlendFunc (GL_DST_COLOR, GL_ZERO) ; 
Draw(b) ; 



glBlendFunc (GL_DST_COLOR, GL_ZERO) ; 
glEnafcle (GL_EIXEL_TBXTURE) ; 
glTexImagelD (inverse table); 
Copy(b) ; 

Vector Operations (a and b are points); 

a . b (dot product) 

glBlendFunc (GL_DST_COLOR, GL_ZERO) ; 
Draw(b) ; 
Set ColorMatrix 
Copy (result) ; 

a ^ b (cross product) 

/* a'^b = ( (ya*zb-za*yb) (za*xb-xa*zb) (xa*yb-ya*xb) ) 
= (ya za xa) * (zb xb yb) - (za xa ya) * (yb zb xb) 

= ( (ya za xa) * (zb xb yb)/(yb zb xb) - (za xa ya) ) * (yb zb xb) */ 
Set ColorMatrix 

glBlendFunc (GL_DST_COLOR, GL_ZERO) ; 
Set ColorMatrix 

glEnaile (GL_PIXEL_TEXTtIEE) ; 
glTexImagelD (inverse table); 

Set ColorMatrix 

Draw(b) ; 
glDisal)le(GL_PIXEL_TEXTUKE) ; 
glBlendEquationEXT (GL_FUNC_SUBTRACT_EXT) ; 
glBlendFunc ( GL_ONE , GL_ONE ) ; 

Set ColorMatrix 

glBlendEquationEXT (GL_FUNC_ADD_EXT) ; 
glBlendFunc (GI,_Dsa?_COLOR, GL_ZERO) ; 

Set ColorMatrix 

Draw(b) ; 

Logical Operations (a and b are float, color, or point); 



glBlendEquationEXT (GL_FUNC_EQUAI,_EXT) ; 
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glBlendSquationEXT (GL_FUNC_N0TEQUA1_EXT) ; 
Draw(b) ; 

Logical Operations (a and b are float): 

a glBlendEquationEXT (GL_FUNC_1ESS_EXT) ; 
Draw{b) ; 

a glBlendEquationEXT (GL_FUNC_LESSEQ_EXT) ; 

Draw(b) ; 



glBlendEquationEXT ( GL_FUNC_GREATER_EXT ) ; 

Draw(b) ; 



glBlendEquationEXT (GL_FUNC_GEEATESEQ_EXT) ; 
Draw(b) ; 

Boolean Operations (a and b are boolean): 



glEnable (GL_PIXEL_TEXTin?E) ; 
glTexImagelD (not table); 
Copy (a) ; 



Draw (a) ; 

glBlendFunc (GL_DST_COLOR, GL_ZERO) ; 
Draw(b) ; 



Draw (a) ; 

glBlendEquationEXT (GL_LOGIC_OP) ; 
glLogicOp (GIi_OR) ; 
Draw(b) ; 

Mathematical functions all take and return type float (c is a constant): 

sin(a) asin(a) 
cos (a) acos(a) 
tan(a) atan(a) 
radians (a) degrees (a) 
sqrt(a) pow(a,c) 
exp(a) log{a) 
mod{a,c) abs(a) 
sign(a) clainp (a, c , c) 
ceil (a) floor (a) 
round(a) step(c, a) 
smoothstep(c, c, a) 

All monadic functions can be implemented via pixel-texture (c is constant): 

glEnable (GL_PIXEL_TEXTUBE) ; 
glTexImagelD (bltin table); 
Copy(a) ; 
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( (float) (x&gt=a) ) 



mod(a,b) ( 

float t = a/b; 

return ( t-floor(t) ) ; 



nly,x) { 

if( x>=0. ) 

( atan(y/x) ); 



if( y>=0. ) 

return ( PI-atan(y/x) ) ; 
return ( -Pl-atan (y/x) ) ; 



Finally, RenderMan has a number of other built-in functions. These include: 

float area (point P) { 

/* texture lod */ 



point calculatenormal (point P) { 

return ( Du(P) '-Dv(P) ) ; 



float depth (point P) ( 
point p = P-I; 
return ( sqrt(p.p) ); 



float di s tance (point pi, point p2) { 
point p = p2-pl; 
return ( sqrt(p.p) ) ; 



Deriv (num, denom) or 
Dv(expr) ( 
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if( V.Rfloat lengtH (point p) { 



color inix(color cO, color cl, float a) { 

Draw(cO) ; 
glColorMask (0,0,0,1); 

Set ColorMatrix 

Draw (a) ; 
glColorMask (1,1,1,1); 

Draw(cl) ; 

) 

noise (float val) or 
noise (float u, floatv) { 

ID or 2D Bicubic Textures 



3D Textures or brute force 2D Texture+Lookup 



color diffuse (poin1 



color phong (point N, point eye, float rough) ( 
color c = 0; 

r = 2* (N.eye) *N-eye; 

for( i=0; isltnlights; i++ ) { 

c += Attenuationi*pow( (r. Li) , 1. /rough) ; 



return ( c ) ; 



color specular (point N, point eye, float rough) { 

for( i=0; isltnlights; i++ ) { 
h = normalize (Li+eye) ; 

c += Attenuationi*pow( (N.h) , 1 . /rough) ; 



return ( c ) ; 



setcontp (color a, float index, float b) or 
setxcorap (point a, float b) or 
setycomp (point a, float b) or 
setzcoinp (point a, float b) ( 
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Set CoIorMatrix 
Copy(b) ; 



float coirp (color c, float index) or 
float xcorap (point a) or 
float Ycontp (point a) or 
float zcomp (point a) { 
Set CoIorMatrix 



spline (a, fl, f 2 , ...) { 

/* if fl, £2, ... uniform */ 
glEnable (GL_PIXEL_TEXTm?E) ; 
glTexImagelD (spline table); 

Copy(a) ; 

/* else unknown? */ 



point buii5> (string name, point norm, dPds, dPdt) or 
color environment (string name, point direction) or 
float shadow (string name, point position) or 
color texture (string name, float s, t) or 
float texture (string name, float s, t) { 
Texture Operations 



point transform(string fromspace, tospace, point p) { 
Primarily Arithmetic 



point refract (point I, point N, float eta) { 
/* from textbook */ 



f resnel (...) { 

/* from textbook */ 



color trace (point location, point direction) { 
/* unknown */ 



@ 
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